NAME¶

createrepo - Create repomd (xml-rpm-metadata) repository

SYNOPSIS¶

createrepo [options] <directory>

DESCRIPTION¶

createrepo is a program that creates a repomd (xml-based rpm metadata) repository from a set of rpms.

OPTIONS¶

-u --baseurl <url>

Optional base URL location for all files.

-o --outputdir <url>

Optional output directory (useful for read only media).

-x --excludes <package>

File globs to exclude, can be specified multiple times.

-i --pkglist <filename>

specify a text file which contains the complete list of files to include in the repository from the set found in the directory. File format is one package per line, no wildcards or globs.

-n --includepkg

specify pkgs to include on the command line. Takes urls as well as local paths.

-q --quiet

Run quietly.

-g --groupfile <groupfile>

A precreated xml filename to point to for group information.
See examples section below for further explanation.

-v --verbose

Run verbosely.

-c --cachedir <path>

Specify a directory to use as a cachedir. This allows createrepo to create a cache of checksums of packages in the repository. In consecutive runs of createrepo over the same repository of files that do not have a complete change out of all packages this decreases the processing time dramatically.

--basedir

Basedir for path to directories in the repodata, default is the current working directory.

--update

If metadata already exists in the outputdir and an rpm is unchanged (based on file size and mtime) since the metadata was generated, reuse the existing metadata rather than recalculating it. In the case of a large repository with only a few new or modified rpms this can significantly reduce I/O and processing time.

--skip-stat

skip the stat() call on a --update, assumes if the filename is the same then the file is still the same (only use this if you're fairly trusting or gullible).

--update-md-path

Use the existing repodata for --update, from this path.

-C --checkts

Don't generate repo metadata, if their timestamps are newer than its rpms. This option decreases the processing time drastically again, if you happen to run it on an unmodified repo, but it is (currently) mutual exclusive with the --split option. NOTE: This command will not notice when packages have been removed from repo. Use --update to handle that.

--split

Run in split media mode. Rather than pass a single directory, take a set of directories corresponding to different volumes in a media set.

-p --pretty

Output xml files in pretty format.

--version

Output version.

-h --help

Show help menu.

-d --database

Generate sqlite databases for use with yum. This is now the default.

--no-database

Do not generate sqlite databases in the repository.

-S --skip-symlinks

Ignore symlinks of packages

-s --checksum

Choose the checksum type used in repomd.xml and for packages in the metadata. The default is now "sha256" (if python has hashlib). The older default was "sha", which is actually "sha1", however explicitly using "sha1" doesn't work on older (3.0.x) versions of yum, you need to specify "sha".

--profile

Output time based profiling information.

--changelog-limit CHANGELOG_LIMIT

Only import the last N changelog entries, from each rpm, into the metadata

--unique-md-filenames

Include the file's checksum in the metadata filename, helps HTTP caching (default)

--simple-md-filenames

Do not include the file's checksum in the metadata filename.

--retain-old-md

Keep around the latest (by timestamp) N copies of the old repodata (so clients with older repomd.xml files can still access it). Default is 0.

--distro

Specify distro tags. Can be specified more than once. Optional syntax specifying a cpeid(http://cpe.mitre.org/) --distro=cpeid,distrotag

--content

Specify keyword/tags about the content of the repository. Can be specified more than once.

--repo

Specify keyword/tags about the repository itself. Can be specified more than once.

--revision

Arbitrary string for a repository revision.

--deltas

Tells createrepo to generate deltarpms and the delta metadata

--oldpackagedirs PATH

paths to look for older pkgs to delta against. Can be specified multiple times

--num-deltas int

the number of older versions to make deltas against. Defaults to 1

--read-pkgs-list READ_PKGS_LIST

output the paths to the pkgs actually read useful with --update

--max-delta-rpm-size MAX_DELTA_RPM_SIZE

max size of an rpm that to run deltarpm against (in bytes)

--workers WORKERS

number of workers to spawn to read rpms

--compress-type

specify which compression method to use: compat (default), xz (may not be available), gz, bz2.

EXAMPLES¶

Here is an example of a repository with a groups file. Note that the groups file should be in the same directory as the rpm packages (i.e. /path/to/rpms/comps.xml).

createrepo -g comps.xml /path/to/rpms

FILES¶

repodata/filelists.xml.gz
repodata/other.xml.gz
repodata/primary.xml.gz
repodata/repomd.xml 

SEE ALSO¶

yum (8) yum.conf (5)

AUTHORS¶

See the Authors file

BUGS¶

Any bugs which are found should be emailed to the mailing list: rpm-metadata@lists.baseurl.org or reported in trac at: http://createrepo.baseurl.org